Add doc for Garmin_txt from Olaf.

diff --git a/gpsbabel/readme.xml b/gpsbabel/readme.xml
index 5cebd9dc6a4704f4e16ff24cbf7d22f38ccaa876..d8e21ce1e83ad12ca36a47636bf777f38b64e61e 100644 (file)
--- a/gpsbabel/readme.xml
+++ b/gpsbabel/readme.xml
@@ -588,6 +588,45 @@ in 2005 and later are supported.  See Garmin's site for more info.)
 This is the format readable that that program.</para>
     </section>
 
+    <section id="garmin_txt">
+      <sectioninfo>
+        <subtitle>Garmin MapSource Text Export (tab delimited).</subtitle>
+      </sectioninfo>
+      <title>garmin_txt</title>
+      <para>
+  garmin_txt is a format that contains nearly all information as in the MapSource main format, GDB.
+garmin_txt has some computed values like distances between routepoints and trackpoints, speed, and course (heading) in addition to the standard data fields.
+      <para>
+      <para>
+The main goal of garmin_txt is to make aviation data more available. Because 
+MapSource supports only the export, GPSBabel gives you the possibility to 
+bring aviation data into MapSource.
+      </para>
+During the export with MapSource, some fields are written using local settings
+of MapSource and Windows. These include grid format, gps datum, distance and
+temperature units, and the representation of date and time fields. GPSBabel 
+tries to read all items automatically. Problems with date and time format can 
+be solved with the options 'date' and 'time'.
+      </para>
+      </para>
+      <para>Options:</para>
+      <para><option>date</option> -  input/output date format (Windows-like. For example  "YYYY/MM/DD")</para>
+      <para><option>datum</option> - write coodinates using this (GPSBabel known!) datum </para>
+      <para><option>dist</option> -  output unit for distance values, M (=metric, m/km/kph) or S (=statue, ft/mi/mph)</para>
+      <para><option>prec</option> -  write coordinates with precision # (# numbers behind dot)</para>
+      <para><option>temp</option> -  output unit for temperature values, C (=celsius) or F (=fahrenheit)</para>
+      <para><option>time</option> -  input/output time format (Windows-like For example, "hh:mm:ss xx")</para>
+      <para><option>utc</option> -   write timestamps x hours relative to UTC</para>
+      <example>
+        <title>garmin_txt example with all options:</title>
+       <screen format="linespecific">gpsbabel -i garmin_txt,date="MM/DD/YYYY",time="hh:mm:ss xx" \
+   -f in.txt \
+   -o garmin_txt,date="DD.MM.YYYY",datum="WGS 72",dist=m,prec=6,temp=c,time="HH:mm:ss",utc=+2 \
+   -F out.txt
+        </screen>
+      </example>
+    </section>
+
     <section id="garmin301">
       <sectioninfo><subtitle>Garmin 301 data.</subtitle></sectioninfo>
       <title>garmin301</title> <para>This is a very simple format that